banner广告

简介

在内容底部或顶部显示的小条形广告。不应将Banner广告放置于文本、图片和应用的其他可点击部分，避免误点。

注意事项

①需要确保在SDK初始化成功后再进行广告请求，否则可能导致广告请求加载失败。

②需要初始化时配置广告基本信息。例如期望尺寸，为避免渲染过程产生广告视图形变，务必和媒体平台配置相同尺寸。通过设置CloooudMNativeExpressBannerViewDelegate代理，获取广告、展示、点击、关闭等回调。值得注意的是一定要设置rootViewController，即跳转落地页需要的viewController。

③在广告接入前需要明确各ADN对应聚合广告样式情况，以确保正确完成广告接入，避免由于广告类型不匹配导致接入报错等情况的发生。

④由于各广告平台对于包名校验规则不同，需确保在媒体平台填写的包名符合各adn平台规范，避免由于包名校验不匹配导致的无广告返回情况的产生。

⑤聚合维度广告是通过广告位ID发起广告请求的，切记不要使用混淆；

接入banner广告

// 创建广告对象
- (void)p_buildAd {
    self.bannerView = [[CloooudNativeExpressBannerView alloc] initWithSlotID:slotID rootViewController:self adSize:size]; // 聚合维度通过广告位ID发起请求；
    self.bannerView.frame = CGRectMake((self.view.width - size.width) / 2.0, self.view.height - size.height - bottom, size.width, size.height);
    self.bannerView.delegate = self;
}
// 触发广告加载
- (void)p_loadAdData {
    [self.bannerView loadAdData];
}
// 聚合维度收到load成功回调后展示
#pragma CloooudMNativeExpressBannerViewDelegate
- (void)nativeExpressBannerAdViewDidLoad:(CloooudNativeExpressBannerView *)bannerAdView {
    [self.view addSubview:self.bannerView];
}

Banner混出信息流广告

混出自渲染信息流时需在nativeExpressBannerAdNeedLayoutUI:canvasView: 回调中实现UI布局，请求、展示广告流程同Banner广告接入流程相同。

- (void)nativeExpressBannerAdNeedLayoutUI:(CloooudNativeExpressBannerView *)bannerAd canvasView:(CloooudMCanvasView *)canvasView {
    // 仅在使用自渲染混出时会回调这个方法
    // 开发者需在该方法中实现UI渲染
    // 从canvasView中获取UI展示的数据，创建UI控件，添加到canvasView中
}

获取展示后广告信息示例

在收到展示回调Visible后访问可获取到正确信息

- (void)logAdInfoAfterShow {
    CloooudMRitInfo *info = [self.bannerView.mediation getShowEcpmInfo];
    // 展示后可获取信息如下
    NSLog(@"ecpm:%@", info.ecpm); // 单位：分
    NSLog(@"platform:%@", info.adnName);
    NSLog(@"ritID:%@", info.slotID);
    NSLog(@"requestID:%@", info.requestID ?: @"None");

    NSLog(@"getAdLoadInfoList:%@", [self.bannerView.mediation getAdLoadInfoList]);
}

接口及回调说明

CloooudNativeExpressBannerView说明

CloooudNativeExpressBannerViewMediationProtocol说明

CloooudNativeExpressBannerViewDelegate说明

CloooudMNativeExpressBannerViewDelegate说明

完整接入示例代码

- (void)loadBannerAd {
    // 先去除上次展示的广告
    [self.bannerView removeFromSuperview];

    // 重新配置广告并加载
    CGSize adSize = CGSizeMake(375, 150); // 根据实际情况设置广告尺寸大小
    CloooudAdSlot *slot = [[CloooudAdSlot alloc] init];
    slot.ID = @"102303353"; // 聚合维度通过广告位ID发起请求；
    CloooudNativeExpressBannerView *bannerView = [[CloooudNativeExpressBannerView alloc] initWithSlot:slot rootViewController:self adSize:adSize];
    bannerView.delegate = self;
    self.bannerView = bannerView;
    [self.bannerView loadAdData];
}

/******** Banner广告回调处理 *********/
#pragma CloooudMNativeExpressBannerViewDelegate
// 广告加载成功
- (void)nativeExpressBannerAdViewDidLoad:(CloooudNativeExpressBannerView *)bannerAdView {
    // 广告加载成功之后，可以调用展示方法，按照实际需要调整代码位置
    [self.view addSubview:bannerAdView];
}

// 广告加载失败
- (void)nativeExpressBannerAdView:(CloooudNativeExpressBannerView *)bannerAdView didLoadFailWithError:(NSError *)error {

}

// 广告已经展示
- (void)nativeExpressBannerAdViewDidBecomeVisible:(CloooudNativeExpressBannerView *)bannerAdView {
    /*
    //  (注意: getShowEcpmInfo 需要在当前广告展示之后调用, 展示之前调用该方法会返回 nil)
    CloooudMRitInfo *info = [bannerAdView.mediation getShowEcpmInfo];
    NSLog(@"ecpm:%@", info.ecpm);
    NSLog(@"platform:%@", info.adnName);
    NSLog(@"ritID:%@", info.slotID);
    NSLog(@"requestID:%@", info.requestID ?: @"None");
    */
}

// 广告被点击
- (void)nativeExpressBannerAdViewDidClick:(CloooudNativeExpressBannerView *)bannerAdView {

}

// 用户选择了负反馈信息
- (void)nativeExpressBannerAdView:(CloooudNativeExpressBannerView *)bannerAdView dislikeWithReason:(NSArray<CloooudDislikeWords *> *)filterwords {

}

// 广告视图被移除
- (void)nativeExpressBannerAdViewDidRemoved:(CloooudNativeExpressBannerView *)nativeExpressAdView {

}       

- (void)nativeExpressBannerAdNeedLayoutUI:(CloooudNativeExpressBannerView *)bannerAd canvasView:(CloooudMCanvasView *)canvasView {
    // 仅在使用自渲染混出时会回调这个方法
    // 开发者需在该方法中实现UI渲染
    // 从canvasView中获取UI展示的数据，创建UI控件，添加到canvasView中
}

详细接入可参照demo。